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CHAPTER 1 
GENERAL INFORMATION 


1.1 INTRODUCTION 
The MDOS Linking Loader combines relocatable object modules produced by the 
Resident M6800 and Macro Assemblers, M6800 Resident FORTRAN Compiler, or 
Resident MPL Compiler into an absolute load module. This resultant jioad module 
is in a format suitable for loading by either the EXORciser loader or disk 
Operating system loader. 
The Linking Loader is a two-pass loader requiring each input module to be read 
twice. During Pass 1, a global symbol table is constructed describing the 
attributes of the various global symbols. During Pass 2, the input modules are 
read again and assigned absolute memory addresses. Module relocation and 
linking is performed during the second pass, and an absolute load module is 
produced. 
1.2 OPERATING ENVIRONMENT 
The minimum equipment required to use the Linking Loader is: 

a. An EXORciser system 

b. An EXORdisk II or EXORdisk III floppy disk drive system 

c. An EXORciser-compatible terminal 

d. 24K of Random Access Memory 

e. Motorola Disk Operating System software (MDOS). 
1.3 ADVANTAGES OF THE LINKING LOADER 


In conjunction with the Resident M6800 Assembler, Macro Assembler, MPL Compiler, 
and FORTRAN Compiler, the Linking Loader permits the user to: 


-« Segment source programs and data 

- Relocate object modules 

- Link modules via global symbols 

- Search user created libraries to satisfy unresolved global symbols 
- Dynamically assign memory 


- Create a memory map describing the location of each object module 
and data block loaded 


- Create a larger system than possible without linking by making smaller 
assembly modules. 
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ASCT - Absolute Section (non-relocatable) 


There may be an unlimited number of absolute sections in a user's 
program. These sections are used to allocate/load/initialize memory 
locations assigned by the programmer rather than the loader; for 
example, addresses assigned to ACIA's and PIA's. 


BSCT - Base Section (direct addressing) 


There is only one base section. The Linking Loader allocates 
portions of this section to each module that needs space in BSCT. 
BSCT is generally used for variables that will be referenced via 
direct addressing. BSCT is limited to locations within the 
addressing range of @ through 255 ($@ through $QQFF). 


CSCT - Blank Common (uninitialized) 


There is only one CSCT. This section is used for blank common 
(similar to FORTRAN blank common). This section cannot’ be 
initialized. 


DSCT - Data Section 


There is only one data section. The Linking Loader allocates 
portions of this section to each module that needs a part of DSCT. 
DSCT is generally used for variables (RAM) which are to be accessed 
via extended mode addressing ($100-$FFFF). 


PSCT - Program Section 


PSCT is similar to DSCT except that it is intended to be used for 
instructions. The PSCT/DSCT division was made to facilitate a 
RAM/ROM dichotomy. 


This section concept is preserved by the Loader during the load process. As a 
module is being loaded, each of its sections is combined with the corresponding 
sections of previously-loaded modules. As a result, the absolute load module 
produced by the Loader will contain one continuous memory area for each section 
type encountered during the load operation. 


In addition to the program segmentation provided by the section concept, the 
relocation and linking scheme supports named common. The named common concept 
provides the function of initialization common areas within BSCT, DSCT, and 
PSCT. In processing named common definitions, the Loader will: 


. Assign to each named common area a size equal to the largest size defined 
for the named common during the load process. 


- Allocate memory at the end of each section for the named common blocks 
defined within that section. 


The load maps shown in Figure 1-1 describe the load process with regard to 
sections and named common. The module EXl requires memory to be reserved in 
BSCT, CSCT, DSCT, and PSCT, although the only space necessary in DSCT is for the 
named common NCOM1. The module EX2 requires that memory be allocated in BSCT, 
CSCT, DSCT, and PSCT. Neither module defines any ASCT blocks. 
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EX1 EX2 


LENGTH LENGTH 
3 BSCT 10 BSCT 
30 CSCT 35 CSCT 
20 NCOM1(DSCT) 20 DSCT 
10 NCOM1(DSCT) 
50 PSCT 
60 PSCT 
5 NCOM2(PSCT) 
10 NCOM3(PSCT) 15 NCOM3(PSCT) 
5 | NCOM2(PSCT) 
DECIMAL 
ADDRESS LOAD MODULE 
0 
SYSTEM AREA 
~ | __sscrpan 
35 BSCT PGM1 
46 BSCT PGM2 
CSCT 
80 
DSCT PGM2 
100 
NCOM1 
120 
PSCT PGM1 
170 
PSCT PGM2 
230 
235 NCOM2 
250 NCOM3 


FIGURE 1-1. Load Maps - Example 1 
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The load module map illustrates a typical memory map that might be produced by 
loading EX1 and EX2. The BSCT for both EX1 and EX2 are allocated memory within 
the first 256 bytes of memory. As shown, the first 32 ($20 hex) bytes of BSCT 
are reserved by the Loader for use by the disk operating system, unless 
otherwise directed. After BSCT, space for blank common is allocated, followed 
by space for the EX2 DSCT. Since EX1 requires no DSCT for its exclusive use, 
none will be allocated. The named common block NCOM1 within DSCT is assigned 
memory at the end of DSCT. Finally, the PSCT's for EX1 and EX2 are allocated 
along with the PSCT common blocks NCOM2 and NCOM3. 


The Loader assigns memory within sections in the order in which the modules are 
specified. Named common blocks are allocated memory at the end of their 
corresponding section, in the order in which they are defined. Figure 1-2 
illustrates a load module map produced by loading EX2, followed by EX1. This 
load module map is slightly different from the map in Figure 1-1 where EX1 was 
loaded first. 


1.4 RELOCATION 


Relocation allows the user to assemble/compile a source program without 
assigning absolute addresses at the time of assembly or compilation. Instead, 
absolute memory assignment is performed at load time. In order to relocate a 
program (within memory), the source program must be assembled with the 
Assembler, using the OPT REL directive, or compiled with the M6800 Resident 
FORTRAN Compiler. The assembler or compiler will produce a relocatable object 
module. These relocatable object modules contain information describing the 
size of each section (ASCT, BSCT, CSCT, and DSCT) and named common area, as well 
as the relocation data. 


In order to load any relocatable object module, the MDOS Linking Loader must be 
used. The Loader assigns addresses and produces an absolute object module 
compatible with the system loader. 


The advantages of using relocation are: 


. Re-assembly is not required for each new absolute load address 
- Relocation via the Linking Loader is faster than re-assembly 
- Dynamic memory assignment of modules is possible 


. Larger programs can be written than was possible before. 
1.5 LINKING 


Linking allows instructions in one program to refer to instructions or data 
which reside within other programs. If all programs are assigned absolute 
addresses during assembly time, it is possible to directly reference another 
program via absolute addresses. However, when using relocatable programs, 
absolute load addresses are not generally known until load time. In order to 
access other relocatable programs or data blocks, external reference symbols 
must be used. These external symbols are commonly called global symbols since 
they may be referenced by any module at load time. Although global symbols are 
used to link modules at load time, they must be explicitly defined and referencd 
at assembly time. This is accomplished by the Assembler directives, XDEF and 
XREF. The XDEF directive indicates which labels defined within a module can be 
referenced by other modules. The XREF directive indicates that the label being 
referenced is defined outside the module. For FORTRAN programs, the compiler 


will generate an XDEF and XREF for each SUBROUTINE and CALL statement, 
respectively. 
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DECIMAL LOAD MODULE 


ADDRESS 
SYSTEM AREA 


0 
BSCT PGM2 
BSCT PGM1 


CSCT 
DSCT PGM2 


32 


42 


45 


80 


100 
NCOM1 
120 
PSCT PGM2 
180 
PSCT PGM1 
230 
NCOM3 
245 
NCOM2 
250 


FIGURE 1-2. Load Map - Example 2 
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At load time, global references are matched with their corresponding global 
definitions. Any reference within a module to a global symbol is updated with 
the load address of the global symbol. If the loader detects a global reference 
without an associated global definition, an undefined global error will be 
printed and a load address of zero will be assigned to the reference. 


1.6 MODULE LIBRARIES 


The Linking Loader can automatically search a file for modules which contain 
definitions satisfying any unresolved global symbols. Such a file is called a 
library file and is composed of one or more object modules merged together. The 
Loader sequentially searches the library file. If a module is found that 
contains a symbol definition satisfying an unresolved global symbol, that module 
will be loaded. Only those modules which can satisfy an unresolved reference 
will be loaded. Since a library file is searched only once, modules which 
reference other modules within the library file should occur within the library 
file before the referenced module. Otherwise, the user must direct the Loader 
to search the library again. 


1.7 MEMORY ASSIGNMENT 


During the load process, absolute addresses are assigned to the program sections 
within the specified modules. Renoat Ws the loader will automatically perform 
this assignment by allocating memory by sections in the order: ASCT, BSCT, 
CSCT, DSCT, and PSCT. However, the user may define the starting and/or ending 
address of any non-ASCT section. In this case, the Loader will first reserve 
memory for those sections with defined load addresses before allocating space 
for any other section. The Loader also permits a user to specify the relative 
section offset of a module within a section. However, a section of a module is 
always loaded in the associated load section in the order in which the module 
was specified. Named common blocks are always assigned memory at the end of the 
associated load section. 


1.8 LOAD MAPS 


The Loader will optionally produce a load map describing the memory layout 
resulting from the loading of the specified modules. Figure 1-3 is an example 
of some of the features included in a typical load map. In addition to this 
full load map, the Loader may be directed to product partial load maps listing 
only the undefined global symbols or section load addresses. 
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NO UNDEFINED SYMBOLS 


MEMORY MAP 


SIZE 
0006 
0006 
COLA 
0030 
0042 
0088 


CTOoOorrn 


STR END COMN 


4510 45 
4406 44 
0000 00 


15 
OB 
19 0000 


0920 004F 0030 


0400 04 
1000 10 


MODULE NAME BSCT 


0000 
0905 
0005 


COMMON SECTIONS 


NA ME 
DCOMM 
OCOMM2 


S SIZE 
D0 0008 
D 0018 


DEFINED SYMBOLS 


MODULE NAME: PG1 


CR 
MSGL 
START 


A 0000 


P 1000 


P 100A 


MODULE NAME: PG3 


ATEST 


A 4406 


MODULE NAMES PG2 


EXBENT 
STACK 


A F564 
8 0019 


FIGURE 1-3. 


41 0020 
87 0000 


DSCT PSCT 
0400 1000 
O40E 1060 
040E 1070 


STR 
0422 
042A 


EOT 
MSG2 


POWERS 


MSG3 


oY 


0004 
0400 


1060 


O40E 
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EXBPRT A F024 
MSGSIZ B 0000 


MSG4 


D 0418 


Loader-Produced Memory Map 


LF 
PGINE 


PGM2 


A OOOA 
P 1016 


P 1070 


CHAPTER 2 


LINKING LOADER COMMANDS 


2.1 INVOKING THE LINKING LOADER 


The Linking Loader must be called while under the control of the MDOS disk 
Operating system. When the user types the command: 


=RLOAD <c/r> 
the disk executive will load the Linking Loader. Upon entry, the loader prints: 


M6800 LINKING LOADER REV n.m 
? ; Ls 
: (where n.m is the revision number) 


The character ? is the Loader prompt, and is printed whenever the Loader has 
completed the last command and is ready for another. 


2.2 LOADER INPUT 


The input to the Loader is in one of two forms -- commands or object modules. 
The Loader commands control the relocation and linking of desired object 
modules. Object modules are produced by the MPL Compiler, or Assembler, or 
Resident FORTRAN Compiler. Each source program assembled or compiled creates a 
single relocatable object module on a disk file. These disk files, or those 
files created by merging one or more of these files, are used as the input to 
the Loader. The Loader command structure provides for the loading of an entire 
file or selected modules within a file. In addition, a disk file may be used as 
a library file. The Loader may also be run under the MDOS CHAIN command. 


2.3 COMMAND FORMAT 


Each Loader command line consists of a sequence of commands and comments, 
followed by a carriage return. The first space in a command line terminates the 
command portion of the line, and the remainder is assumed to be comments. 
Multiple commands may appear on a line by using a semicolon (;) as a command 
separator. The format of a command line may thus be defined as: 


{command>s<conmand>°s | [<space>E<conments>3] <e/r> 


EXAMPLE: STRB=@;STRD=$1000; STRP=$4000 
IDON 
LOAD=PG1 


The commands in a command line are executed only after the Loader detects a 
carriage return. 


If a command line is entered incorrectly, the line may be corrected in either of 
two manners. First, the command line may be deleted completely by typing CTRL X 
(the CTRL and X keys typed simultaneously). This causes the Loader to ignore 
the current command line, and issue a CR, LF, and await a new command input 
line. However, instead of deleting the entire command line, it may be corrected 
by deleting the character(s) in error. This is accomplished by typing a RUBOUT 
to delete the last character typed. The typing of a RUBOUT also causes the last 
character entered to be printed. After deleting the character(s) in error, the 
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corrected version of the command line may be entered. The (MDOS) CTRL D key 
allows the operator to redisplay the line to show a "clean" copy of the line for 
operator inspection. Thus, full compatibility is maintained with the normal 
MDOS .KEYIN special character functions. 


The Loader will execute all the commands in a command line before another prompt 
is issued. If an error is detected while attempting to process a command, that 
command will be terminated. The remaining commands in the command line will be 
ignored. 


When using multiple commands per line, it should be noted that selected commands 
require that they are the last command on a line, and include: 


- INIT 

- all intermediate file commands (IF, IFOF, IFON) 

- OBJ 
2.4 LOADER COMMANDS 
The Loader commands are divided into three classes: 

1. control commands 

2. load directives 

3. state directives. 
The control commands are used to initiate Passes 1 and 2 of the Loader, as well 
as to return to EXbug or the disk operating system. The load directives are 
used to identify the modules to be loaded. Finally, the state directives direct 
the assignment of memory to the various program sections and the production of a 
load map. 
2.4.1 Command Nomenclature 

<f-name> - Used to indicate the name of a disk file to be used by the 

Loader. Unless specified, the file is assumed to have a suffix 


of "RO" and drive number of @. For the format of the file 
name, consult the MDOS Manual. (Example: PG1.R0:1) 


Used to indicate a decimal or hexadecimal number. Unless 
preceded by a $ character (which is used to denote 
hexadecimal), the number will be interpreted as decimal. 
ee explicitly stated otherwise, the allowable number range 
wi eQ: 


<number> 


Q - 65,535 (decimal ) 
$9 - $FFFF (hexadecimal ) 


[ ] - Used to indicate that the enclosed directive(s) is optional. 
[ ] - Used to indicate that the enclosed directive may be 
0 repeated from 9 to 99 times, up to a total of 79 characters 
maximum. 


{ } - Indicates that one of the enclosed options must be used. 
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2.5 CONTROL COMMANDS 


2.51 EXIT 


cme 
FORMAT: cat ate i 


DESCRIPTION: 


20502 IDOF = 
FORMAT: IDOF 
DESCRIPTION: 


2.5.3 IDON - 
FORMAT: IDON 
DESCRIPTION: 


The EXIT command causes control to be returned to the disk 
operating system after all Loader files have been closed. 


The MDOS version of the Loader allows the user to define the 
starting execution address of the object program. If the <number> 
option is specified, the given absolute number will be used as the 
starting execution address. This address must be a valid address 
within the program. The <namel> option is similar to the <number> 
option except that <name> must be a valid global symbol. If 
neither option is used, the starting address defaults to the 
address associated with the label appearing in the operand field 
of the END statement in the assembled program. If two or more 
modules have END statements with operands, the operand associated 
with the first module loaded will be used as the starting address. 


Suppress Printing of Module ID 


This command suppresses the printing of the name and printable 
information associated with each object module loaded or 
encountered in a library file. For assembly language programs, 
this information is specified via the NAM and IDNT directives. 


Print Module ID 


This command causes the name and printable information associated 
with each object module loaded or encountered in a library file to 
be printed at the console device. For assembly language programs, 
this information is specified via the NAM and IDNT directives. 
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2.5.4 IF - Intermediate File 


FORMAT: IF=<f-name> 


DESCRIPTION: 


EXAMPLE: 


2.5.9 IFOF - 
FORMAT: IFOF 
DESCRIPTION: 


2ede6 IFON a 
FORMAT: IFON 
DESCRIPTION: 


2.5.7 INIT - 
FORMAT: INIT 
DESCRIPTION: 


The IF command defines a file to be used as an intermediate file. 
An intermediate file is a copy of all Pass 1 Loader commands and 
object modules. It is used to direct the load operation during 
Pass 2, instead of requiring the user to retype the Pass 1 command 
sequence during Pass 2. The IF command also automatically places 
the Loader in intermediate file mode similar to the IFON command. 
Like the IFON command, the IF command must be the last command in 
a command line. 


The IF file name must be a valid disk file name and may not be the 
name of an existing file on the specified diskette. Upon proper 
exiting from the Loader, the IF file is deleted. 


IF=IFILE Defines IFILE on drive @ as the intermediate file. 
Default suffix is "IF". 


Intermediate File Mode Off 


IFOF temporarily suppresses the creation of the intermediate file 
until an IFON directive is encountered. This command must be the 
last command in a command line. 


Intermediate File Mode On 


This command directs the Loader to write all further commands and 
object modules onto the intermediate file. This directive remains 
in effect until an IFOF or Pass 2 command is detected. The IFON 
command must be the last command on a command line. IFON is 
implied when the intermediate file is defined by the IF command. 
If an intermediate file is to be used during Pass 2, the IFON 
directive must be in effect. 


Initialize Loader 


INIT initializes the Loader for Pass 1. This command is performed 
automatically when the Loader is first initiated. The use of this 
command permits the user to restart the Loader when entry errors 
are made, without having to exit back to MDOS. Any previously 
created object and/or intermediate files will be deleted. The 
INIT comand must be the last command in a command line. 
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2.5.8 MO - Map Output 


. _ |<f-name> 
FORMAT: MO= eeviee| 


DESCRIPTION: The MO command is used to specify the media on which the map 
output is to be produced. The MAP output will default to the 
console printer. 


If a file name is specified, it must not be the name of an 
existing disk file. The map cannot be directed to a file during 
Pass 2 or whenever an intermediate file is being used. 


A map can be produced on the console printer or line printer by 
specifying the mnemonic #CN or #LP, respectively. 


EXAMPLE: MO=MAPFL All output generated by the MAP command will be 
written on file MAPFL on drive @. 
MO=#LP The line printer will be used for all future map 
output. 


2.5.9 OBJ = Produces Load Module 


FORMAT: OBJA=<file-name> 
OBJUX=<file-name>[ printed information] 


DESCRIPTION: This loader command is used with the MDOS Loader to initiate the 
second pass of the Loader. During this pass, an object file is 
created on disk with the name <file-name>. This file may not be 
the name of an existing file on the specified disk. The file will 
be created on disk @ unless disk 1 is specified in <file-name>. 
The type of object file produced by the Loader is determined by 
the command form as follows: 


OBJA - This format creates an absolute memory image file suitable 
for loading via the MDOS LOAD command. A default file 
suffix of 'LO' and drive @ will be used if none are 
specified. 


OBJX - An object file in EXORciser loadable format (SQ, Sl, and 
S9 records) is created via this command form. This file 
may not be loaded via the MDOS LOAD command without first 
using the MDOS EXBIN command. However, files created in 
EXORciser loadable format may be copied to cassette or 
paper tape and loaded via EXbug. A default suffix of 'LX' 
and drive @ will be used if none are specified with the 
file name. 


If an intermediate file (IF) was generated during the first pass of the Loader, 
the second pass automatically processes the commands entered during the first 
pass. In the event that an intermediate file was not created, the same sequence 
of commands used during the first pass must be repeated. Regardless of the use 
of an intermediate file, the OBJA or OBJX command must be the last command on 
the command line. 
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EXAMPLES: 


OBJX=SORT BINARY SORT PROGRAM 


This command initiates the second pass of the Loader, 
which will create an EXORciser loadable file on disk 
file 'SORT.LX:0'. The SO record will contain the file 
named SORT and the ASCII character string ‘BINARY SORT 
PROGRAM'. 


OBJA=REPORT: 1 


The Loader will create the absolute object file on file 
"REPORT.LO' on drive 1. 


2.6 LOAD DIRECTIVES 


2.6.1 LIB - Library Search 


99 
FORMAT: L1B=<F-nane> [,C<F-nane> I 0 


DESCRIPTION: 


EXAMPLE: 


The LIB command instructs the Loader to search the specified file 
name(s) for those modules which satisfy any undefined global 
references. Any module that satisfies an unresolved global 
reference will be loaded. A suffix of -.RO and logical drive of 
:@ are assumed for <f-name>. 


A library file is a collection of individual relocatable object 
modules which were merged into a single file. 


Modules loaded via the LIB command may also reference global 
symbols that are not defined. Since a library file is searched 
only once for each LIB command, it should be made with care so 
that no module has any reference to a prior (higher level) module, 
or multiple passes of the same library must be done. 


It should be noted that the Macro Assembler and certain compilers 
(FORTRAN) produce a single relocatable object module in a file. 
Since these single object module files can be merged together into 
other (library) files, the terms “object file" and “object module" 
are not necessarily equivalent. 


LIB=MLIB:1 The modules on file MLIB.RO on drive 1 will be 
searched to resolve any unsatisfied global 
references. 
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2.6.2 LOAD - Load a File 
FORMAT: LOAD=<f-name> [ [ <f-name> i - 


DESCRIPTION: 


EXAMPLE : 


The LOAD command directs the Loader to load the specified object 
files. 


The LOAD command directs the Loader to load all object modules 
found in the specified file name(s). The file name could be a 
library file, but the LOAD command, unlike the LIB command, wil] 
load each object module found, irregardless of whether or not it 
is needed. 


A suffix of .RO and logical drive :@ are assumed. 


LOAD=PGM1:1 Loads all modules within file PGM1.RO on disk 
drive 1 


LOAD=PGM1,RAM:1,PGM2,PGM3 Loads all modules within files PGM1.RO 
on drive @, RAM.RO on drive 1, 
PGM2.RO on drive @, and PGM3.RO on 
drive @. 


2.7 STATE COMMANDS 


2.7.1 BASE - Initialize Minimum Load Address 


FORMAT: BASE [=<number> ] 


DESCRIPTION: 


EXAMPLE: 


The BASE command allows the user to specify an address above which 
his program will load. The BASE command affects only the memory 
assignment of CSCT, DSCT, and PSCT. Memory assignments related to 
BSCT, ASCT, and those sections with defined starting/ending 
addresses (via commands STR or END) are not affected by this 
command. 


The use of the <number> option is used to define the lowest 
address which may be assigned to CSCT, DSCT, or PSCT. If the 
<number> option is not specified, the lowest assignable address 
will default to the next modulo 8 address following MDOS. This 
format of BASE allows the user to load his program above MDOS 
without having to know where MDOS ends. If the BASE command is 
not specified, a default address of $20 (32 decimal) will be used 
as the lowest load address during memory assignment. 


BASE Unassigned CSCT, DSCT, and PSCT will be assigned load 
addresses above MDOS. 


2-7-2 CUR - Set Current Location Counter 


B 
p 


FORMAT: CUR<D +) <number> 


DESCRIPTION: 


EXAMPLE : 


EXAMPLE: 


The CUR command is used to modify the Loader's current relative 
loading address of the specified section (BSCT, DSCT, or PSCT). 
The CUR command must be used prior to the LOAD or LIB command so 
as to update the loading address first. If the '\' option is not 
specified, the relative load address for the appropriate section 
will be set equal to the given <number> starting section plus its 
value (see STR command). This <number> must be equal to or 
greater than the section's current relative load address. This 
form of the CUR command allows the user to start a module section 
at a defined address. For PSCT, the <number> entered is added to 
the absolute value for STRP to obtain the new PSCT load address 
value. The following example loads four 1K EPROM's at $4400, 
$4800, $5000, and $8C00 from multiple files. Each LOAD command 
utilizes less than $400 bytes in PSCT (starting PSCT=$4400). 


?STRP=$4400 


?LOAD=FILE11, FILE12,FILE13 EPROM at $4400 

?CURP=$400 

?LOAD=F ILE21,FILE22,FILE23 EPROM at $4800 ($4400 + $400) 
?CURP=$C00 

?LOAD=F ILE31,FILE32 EPROM at $5000 ($4400 + $C00) 


?CURP=$4800 
?LOAD=FILE41,FILE42,FILE43,FILE44 EPROM at $8C00 ($4400 + $4800) 


The '\' option affects the section's relative load address in a 
different manner. This option causes all future modules to be 
loaded at an address which is a power of two relative to the start 
of the section (2,4,8, etc.). The specified <number> defines the 
given power of two. This option remains in effect until the 
option is specified again or until the current pass of the Loader 
is complete. If the '\' option is in effect when memory is 
assigned to the starting section addresses, the starting address 
of the section will also be assigned a load address which is a 
power of two. This option does not apply to named common blocks 
within the specified section. 


If the CUR directive is not used, each module will normally be 
loaded at the next load address in the appropriate section 
(contiguously loaded modules). However, modules created via the 


FORTRAN Compiler will be loaded at the next even address. 


CURP=$100 Sets the relative PSCT location counter to $100 
plus STRP value. 


CURP=\16 Causes the Loader to load all future PSCT sections 
at a relative address within PSCT which is modulo 16 
plus the STRP value. 


NOTE 


When using the CUR command within an MDOS chain 
file, the '\' option must use '\\' instead of '\'. 
(See CHAIN command description in the MDOS Manual.) 
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EXAMPLE : 


STRP=$4001 
CURP= $400 
LOAD=PG1,PG2,PG3 


If each file is a single module with less than 1K of PSCT in each 
one, then each module's starting PSCT address would be assigned as 
follows: 


PG1=$4001 
PG2=$4401 
PG3=$4801 


2.7.3 DEF - Loader Symbol Definition 


FORMAT: DEF: 
DESCRIPTION: 
EXAMPLE : 


ASCT 
came | BSCT 


<namel>= ales »DSCT 
PSCT 


The DEF command is used to define a global symbol and enter it in 
the global symbol table. The symbol to be defined is given by 
namel and must be a valid Macro Assembler variable name. The 
symbol may not currently be defined. If the <number> option is 
used, the symbol will be defined with the given number as the 
relatived address within the specified section. The DEF command 
may be used to provide another name for a previously defined 
symbol by using the <name2> option. <name2> must be a currently 
defined global symbol. The section options -- ASCT, BSCT, DSCT, 
PSCT -- are used to define the section associated with the defined 
section. ASCT is the default section. 


DEF :ACIA1=$EC10,ASCT Defines symbol ACIA1 as an ASCT symbol 
with absolute address $£C10 (hexadecimal). 


2.7.4 END - Ending Address 


B 


FORMAT: END<C>=<number> 


DESCRIPTION: 


EXAMPLE: 


D 
P 


The END commands are used to set the absolute ending address of 
the associated section (BSCT, CSCT, DSCT, PSCT). If both an 
ending and starting address are defined, the size described by 
these boundaries must be equal to or greater than the size of the 
associated section. 


NOTE 


An ending address of $0000 will reset any previous 
END directive for the corresponding section. 


ENDB=255 BSCT will be allocated such that the last address 
reserved is 255 (decimal). 
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2.7.5 MAP - Prints Load Maps 


DESCRIPTION: 


C 
FORMAT: MAP) F 
S 
U 


The MAP commands are used to display the current state of the 
modules loaded or the Loader's state directives. 


MAPC - 


MAPF = 


MAPS - 


MAPU = 


Prints the current size, user defined starting address, and 
user defined ending address for each of the sections, as 
well as the size, starting address, and ending address for 
each ASCT defined. 


A full map of the state of the loaded modules is produced 
after the Loader assigns memory. This map includes a list 
of any undefined symbols, a section load map, a load map 
for each defined module and named common, and a defined 
global symbol map. If a user assignment error (UAE) 
exists, this command cannot be completed. Use the MAPC 
command to determine the cause of the error. 


The Loader assigns memory to those sections not defined by 
a user supplied starting and/or ending address. A memory 
load map, which defines the size, starting address and 
ending address for each section, is printed. If a user 
assignment error (UAE) exists, this command cannot be 
completed. Use the MAPC command to determine the cause of 
the error. 


Prints a list of all global references which currently 
remain undefined. 


2.7.6 STR - Starting Address 


B 


FORMAT: STR} C\=j)<number> 
<global ASCT symbol> 


DESCRIPTION: 


EXAMPLE: 


D 
P. 


The STR commands set the absolute starting address of the 
associated section (BSCT, CSCT, DSCT, PSCT). Those sections whose 
starting address is not defined by the user will be assigned a 
starting address by the loader. 


NOTE 
A starting address of $FFFF will reset any previous 
STR directive for the corresponding section. This 


will allow the Loader to define the starting address. 


STRP=$1000 PSCT will be allocated memory starting at $1000. 
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CHAPTER 3 
SAMPLE OPERATIONS WITH THE LINKING LOADER 


3.1 INTRODUCTION 


This chapter provides a description of the operation of the Loader in typical 
applications. To demonstrate the use of the Loader, a simple message printing 
program will be used. This program consists of three modules which reference 
instruction sequences or data within each other. As assembly listing of each 
module is shown in Figures 3-l, 3-2, and 3-3. 


3.2 SIMPLIFIED LOADER OPERATION 


The simplest form of the Loader's operation is shown in Figure 3-4. In this 
example, all three files -- PGl, PG2, and PG3 -- are loaded, and the object file 
PG@123 is created. The sequence of steps shown in Figure 3-4 is as follows: 


1. The LOAD command loads the first file, PG1.R0:9. During all load 
operations, a global symbol table of all external definitions and 
references is built. 


2. The LOAD command loads the next two files, PG2 and PG3. Notice the 
default suffix 'RO' and drive number 'f' are assumed. 


3. The OBJA command starts pass 2 of the load function, which will create an 
absolute memory image object file named PG123 on drive Q with the suffix 
'LO'. This command also assigns memory addresses to the various program 
sections. The use of the OBJX command, instead of OBJA, would have a 
similar effect, except an EXORciser load image would be produced. 


4. Since an intermediate file was not created in pass 1, all ‘commands 
entered in pass 1, with the exception of MAP commands, must be repeated. 
In pass 2, the LOAD command generates the absolute code for the object 
file. Notice that all three files are loaded with one load command this 
time. 


5. The MAPU command is not really necessary here, but was entered to verify 
that no undefined symbols exist. 


6. A complete memory map is produced by the MAPF command. In the first part 
of the map (6a), any undefined external references are listed. In the 
next part (6b), the section type, the size, starting address, ending 
address, and size of the section's common block are listed for each 
program section. For example, PG123's DSCT area will have a size of 42 
(hex) bytes, of which 20 (hex) bytes are in common. The DSCT area will 
start at address $6A and end at $AB. The starting address of the various 
sections for each program module is given in the next map part (6c). As 
seen from the map, PG2 PSCT starts at address $FD, which corresponds to 
the PG2 instruction: 


PGM2 = CLRA 
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PAGE 


00001 
00002 
00003 
00004 


00006 
00007 
00008 
00009 
00010 


00012 


00014 
00015 
00016 
090017 
00018 


00020 
00021 
00022 
00023 
00024 


00026 
09027 
00028 
00029 


ool 


PG 


FO24 


0004 
OOO0A 
0000 


oS A: 


Pe > 


1 


te it th te dt 


E 


te 
bs 


L 


PGl PROGRAM TO PRINT OUT MESSAGES (MAIN) 
NAM PGI 
OPT REL»CREF»NOG 
TTL PROGRAM TO PRINT OUT MESSAGES (MAIN) 
IONT 08/10/79 MAIN MESG PROGRAM —-— MODULE #1 
ASSEMBLY PROCEDURE: RASM 3-00 MDOS 3-00 
=RASM PGI1;3LN=76 
PROGRAM PARTS: PGl»s PG2+s PG3 


COMPUTER: M6800 


XBPRT EQU 


EOT EQU 


F EQU 


CR EQU 


tt tt 


$F024 EXBUG PRINT ROUTINE 


* ASCII CHARACTER EQUATES 


4 END OF TEXT 
$A LINE FEED 
$D CARRIAGE RETURN 


EXTERNAL REFERENCES 


XREF 
XREF 
XREF 


ATEST 
DSCT2MSG39MSG4sANY2STACK 
EX BENT +PGM2 


EXTERNAL DEFINITIONS 


XDEF 
XDEF 


FIGURE 3-1. 


MSG29MSG1sEXBPRT» START ePGLNE 
MSGSIZeEOTeLFeCR 


Message Program 1 (PG1) 
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PAGE 002 PGIL eSA:1 PGl PROGRAM TO PRINT OUT MESSAGES (MAIN) 


90031 * COMMON MESSAGE AREA 

00032 * (NAMED COMMON "OCOMM" IN DSCT) 

00033 ~ 

00034N 0000 DCOMM COMM DSCT 

00035N 0000 0000 P MSGI1P FDB MSG1 PTR TO MESG 1 CIN PSCT) 
00036N 0002 0000 OD MSG2P FDB MSG2 PTR TO MESG 2 CIN DSCT) 
00037N 0004 0000 A MSG3P FDB MSG3 PTR TO MESG 3 (XREF IN DSCT) 
00038N 0006 0000 A MSG4P FDB MSG4 PTR TO MESG 4 (XREF IN CSCT) 
00040 * MESSAGES 1 AND 2 

00041 * (NEW NAMED COMMON “DCOMM2" IN DSCT) 

00042 * 

00043N 0000 DOCOMM2 COMM DSCT 

00044N 0000 9001 A CMSGCT RMB 1 COMMON MESSAGE COUNT 
O0045N 0001 OOL4 A CMSG RMB 20 COMMON MESSAGE 

00047C 0000 CSCT 3LANK COMMON SECTION 
00048C 0000 0010 A MSGCST RMB 16 RESERVE 16 BYTES 

0005CD 0000 OSCT DATA SECTION 

000510 0000 4D A MSG2 FCC NMESSAGE 2N 

00052D 0009 04 A FCB EDT DELINEATE END OF MESSAGE 
00054P 0000 PSCT PROGRAM SECTION 

00055P 0090 4D A MSGI FCC \MESSAGE LN 

00056P 0009 04 A FCB EOT 

000588 9000 BSCT BASE SECTION 

000598 0000 0001 A MSGSTZ RMB 1 MESG SIZE STORAGE 


FIGURE 3-1. Message Program 1 (PG1) (cont'd) 
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PAGE 


00061 
00062 
09063 
00064P 


00066P 
ON067P 
O00C6BP 
00069P 
00070 

00071 

00072 

00073P 
O0O07T4P 
OOOTSP 
O00076P 
O00TTP 
OO90T78P 
000T9 

00080 

00081 

o0cBb2P 
00033P 
00084P 
00035P 
OGO8B6P 
00087P 
0008BP 
00089P 
00090P 
OOO09LP 
09092P 
00093P 
00094P 
00095P 
00096P 
00097P 
09098P 


001008 
00101 
00102 
00103 
00104 
001058 
001068 


00108D 
09109D 
00110D 


00112 
00113 


003 


PGl 


OOOA 


OOOA 8E 
OOOD FE 
0010 
0013 7E 


0016 CE 
0019 
OO1C FE 
OO1F 3) 
0022 
0025 BD 


0028 
0028 FF 
OO2E CF 
OO3L FF 
0034 F6 
0037 D7 
9039 FE 
003C A6 
OO3E 
O003F FF 
0042 FE 
0045 
0047 08 
0048 FF 
QC04B 5A 
004C 26 
OO4E TE 


0001 


9001 


9003 


000A 
000A 96 
O000C DE 


eSAs1l PGL 
* 
PSCT 
0000 A START LOS 
o0oco N LDX 
FO24 A JSR 
0000 A JMP 
N00G A PGINE LOX 
FO24 A JSR 
0004 $%.N LOX 
FO24 A JSR 
0000 A LOX 
FO24 A JSR 
* 
0000 C LOX 
0003 8B STxX 
OoOoL N LDX 
OoCcl B STX 
9000 N LDOAB 
00 B STAB 
0001 8 LOOP1i LDX 
00 A LDAA 
INX 
0001 8B STX 
0003 8B LOX 
00 A STAA 
INX 
0003 8B STX 
DECB 
EB 0039 BNE 
0000 A JMP 
BSCT 
* NOTE: 
0002 A FROMPT RMB 
0002 A TOPNTR RMB 
OSCcT 
Ol 8 LDAA 
03 8 LDX 
TEL 
OCOA P END 


TOTAL ERRORS 00000--00000 


FIGURE 3-1. 


PROGRAM SECTION 
EXECUTION STARTS AT "START" 


#STACK 
MSG1P 
EXBPRT 
PGM2 


PROGRAM 2 RETURNS TO 


#MSG3 
EXBPRT 
MSG3P 
EXBPRT 
#MSG4 
EXBPRT 


#MSGCST 
TOPNTR 
#CMSG 
FROMPT 
CMSGCT 
MSGSIZ 
FROMPT 
OX 


FROMPT 
TOPNTR 
OeX 

TOPNTR 


LOOP1 
ATEST 


IF FORWARD REFERENCED, 
THEREFORE ALL BSCT VARIABLES SHOULD BE 
DEFINED BEFGRE REFERENCEDe) 


2 
2 


FROMPT 
TOPNTR 


PROGRAM TO PRINT OUT MESSAGES (MAIN) 


PROGRAM SECTION 


SET UP STACK REGISTER 
GET MESSAGE 1 POINTER 
PRINT MESSAGE 1 

GO TO PROGRAM 2 (XREF) 


(XREF) 


THIS POINT (XDEF) 


GET MESSAGE 3 ADDRESS 
PRINT MESSAGE 3 
GET MESSAGE 3 POINTER 
PRINT MESSAGE 3 AGAIN 
PRINT MESSAGE 4 


MOVE MESSAGE FROM CMSG IN DCOMM2 TO BLANK COMMON 


MESSAGE DESTINATION ADDRESS 
MESSAGE ADDRESS (FROM) 


MESSAGE LENGTH 

SAVE MESG LENGTH 

GET SOURCE POINTER 
GET BYTE 

UPDATE SOURCE POINTER 


GET DESTINATION POINTER 
SAVE BYTE 
UPDATE DESTINATION PCINTER 


UPDATE CHARACTER COUNTER 
LOOP 
GOTO PROGRAM W/ASCT REGIONS 


DIRECT ADDRESSING SECTION 
EXTENDED ADOR IS USED. 


FROM POINTER 
TO POINTER 


DATA SECTION 
***DIRECT ADDRESSING USED*¥** 
(EXAMPLES ONLY -— NOT EXECUTED) 


CROSS REFERENCE TABLE 


START 
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Message Program 1 (PG1) (cont'd) 


ATEST 
CMSG 
CMSGCT 
CR 
DCO™M 
DCCMM2 
ECT 
EXBENT 
EXBPRT 
FREOMPT 
LF 
LOOP1 
MS61 
MSGLP 
MSG2 
MSG2P 
MSG3 
MSG3P 
MSG4 
MSG4P 
MSGCST 
MSGSIZ 
PGILNE 
PGM2 
STACK 
START 
TOPNTR 


eSAs 1 Pp 


90022*00098 
00045*00084 
00044*00086 
00018*00629 
00034* 
00043* 
90016*00029 
00024% 
00012*00028 
90085 90088 
90017*00029 
00088*00097 
00028 00035 
00035*00067 
00028 00036 
00036 
00023*00037 
9003 7*00075 
00023*00038 
00038* 
00048*00082 
90029 00059* 
00028 00073 
00024*00069 
00023*00066 
00028 00066* 


Gl 


00052 


00068 
00091 


00055%* 


- 


CROSS REFERENCE 


00056 


TABLE 


00074 00076 00078 


00105*00109 


00051* 


00073 


oocTT? 


00087 


00113 


00083 00092 00095 00106*00110 


FIGURE 3-1. Message Program 1 (PG1) (cont'd) 
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PAGE 


09001 
00002 
00003 
00004 


09006 
C0007 
00008 
00009 
00010 


00012 


00014 
OO01L5S 
00016 
090017 
00018 
00019 
00020 


00022 

00023 

00024N 
00025N 
00026N 
00027N 
00028N 


00030N 
O0031N 
00032N 
00033N 
00034 


09036 

00037 

000369) 
000399 
090400 
000410 
000420 


ool 


0000 
0000 
0002 
0004 
0006 


0000 
0000 
0001 
0014 


0000 
0000 
00909 
000A 
0013 


PG2 


F564 


4D 
00 
40 
00 


oSAs 


A 


PrPPrP 


z2z2Prp 


bebe pb 


1 PG2 


te tt tt ode de 


EXBENT 


te ot ot 


MESSAGE PRINTER SUBPROGRAM 


NAM 
OPT 
TTL 
IONT 


PG2 

CREF »REL»NOG 

MESSAGE PRINTER SUSPROGRAM 

08/10/79 MESG PRNTR SUBPROG — MODULE #2 


ASSEMBLY PROCEDURE: RASM 3200 MDOS 3-200 
=RASM PG2sLN=76 


PROGRAM PARTS: PGle PG2s PG3 


COMPUTER: M6800 


EQU 


XDEF 
KREF 
XREF 
XREF 


$F 564 EXBUG ENTRY POINT 


XDEFS AND XREFS 


MSG3 e+MSG4eSTACKsEXBENT »PGM2 
BSCT:2MSGSIZ 
EX38PRT+PGINEoMSG1LeMSG2 
FEOT»sCReLlF 


* MESSAGE POINTER AREA {(DCOMM) 


DCOMM 

MSGLPT 
MSG2PT 
MSG3PT 
MSG4PT 


DCOMM2 
CMSGCT 
CMSG 


CMSGE 


+ 


3 


COMM 
RMB 
RMB 
RMB 
RMB 


COMM 
FCB 
FEC 
FCB 
EQU 


DSCT 

MSG3 FCC 
FCB 

MSG4 FCC 
FCB 

FIGURE 3-2. 


OSCT 
2 


2 
2 
Z. 


DOSCT 

CMSGE-CMSG »« COMMON MESSAGE CHAR COUNT! 
\COMMON TEST PROGRAM\ 

CReLFelFe ENT 

* END OF MESSAGE 


MESSAGES 3 AND 4 


\MESSAGE 3\ 
EOT 
\MESSAGE 4\ 
EOT 


Message Program 2 (PG2) 
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PAGE 0 


00044 

00045 

00046P 
00047P 
00048P 
00049P 
O0O50P 
90051P 
00052P 
09053P 
090054P 
09055P 


090578 
0005388 
000598 


00061 


O02 PG2 


0000 

0000 4F 
0001 97 
0003 FE 
0006 30 
9009 CE 
OO0Cc BD 
OOCF FE 
0012 BD 
0015 TE 


0000 
0000 
9014 


eSAzl Pp 


* START OF PROGRAM 2 


se 
ne 


PGM2 
00 
0090 
9000 
0000 
0000 
0002 
0000 
0000 


Prearvrrra2azp 


0014 A 
OOOL A STAC 


TOTAL ERRORS 00900--00000 


ND 0001 
ND 0000 
ND 9018 


F564 


D 0000 


ND 90002 
9) 0000 
ND 0004 
DN OODA 
ND 0006 


DP 0000 
08 0014 


CMSG 
CMSGCT 
CMSGE 
CR 

DCG MM 
DCOMM2 
EQT 
EXRENT 
EXBPRT 
LF 
MSGI 
MSGIPT 
MSG2 
MSG 2PT 
MSG3 
MSG3PT 
MSG4 
MSG4PT 
MSGSIZ 
PGINE 
PGM2 
STACK 


00031 00032* 
00031* 

00031 00034* 
00020*00033 
00024* 
00030* 
00020*00033 
00012*00017 
00019*00050 
00020*00033 
00019* 
00025*00049 
00019*00051 
00026*00053 
00017 00039* 
00027% 

00017 00041* 
00028* 
00018*00048 
00019*00055 
00017 00047* 
00017 00059% 


FIGURE 3-2. 


G2 MESSAGE PRINTER SUBPROGRAM 


BSCT 


K RMB 1 


00040 00042 


00052 00054 
00033 
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MSGSIZ 
MSGLPT 
EXBPRT 
#MSG2 

EXBPRT 
MSG2PT 
EXBPRT 
PGINE 


INI Te MESG LENGTH 
PRINT MESSAGE 1 


PRINT MESSAGE 2 
PRINT MESSAGE 2 AGAIN 


RETURN TO PROGRAM ONE 


DIRECT ADDRESSING SECTION 


STACK STORAGE AREA 


Message Program 2 (PG2) (cont'd) 


PAGE 001 


00001 
00002 
00003 
00004 


00006 
00007 
00008 
00009 
00010 


00012 
00013 


OOOLS 
00016 
09017C 
00018C 


09020A 
O0021A 
00022A 
000234 


O0025A 
00026A 


OO027A 


00029P 
00030P 
09031P 
00032P 
00033P 
00034P 


00036 


0000 
0000 


0000 
4406 
4406 
4409 


4510 
4510 
4513 


0000 
0000 
0002 
0004 
009006 
0008 


PG3 


TE 


38D 
TE 


eSAz1 PG3 


te 36 3b 4b 4 


TOTAL ERRORS 00000--00000 


D 4406 
4510 
C 0000 


DP 0000 


ATE 
ATE 


ST 
ST2 


CMSG 

EXBENT 
EXBPRT 
POWERS 


*xX=PROGRAM TO ILLUSTRATE USE GF ASCT 


NAM 
TTL 
OPT 
IONT 


PG3 

***PROGRAM TO ILLUSTRATE USE OF ASCT 
REL»CREF 

08/10/79 ASCT ILLUSTRATION —- MODULE #3 


ASSEMBLY PROCEDURE: 
=RASM PG3:15LN=76 


PROGRAM PARTS: 


RASM 3-00 “DOS 3200 


PGle PG2»s PG3 


COMPUTER: M6800 
XOFF ATEST» POWERS 
XREF EXBPRT+eEXBENT 
* BLANK COMMON 

cSCT 
0030 A CMSG RMB $30 

ASCT UNNECESSARY! 

ORG $4406 e ORG CAUSES ASCT! 
0000 C ATEST LDX #CMSG START OF COMMON MESSAGE 
4510 A JMP ATEST2 

ORG $4510 
0000 A ATEST2 JSR EX BPRT PRINT MESSAGE 
0000 A JMP EXBENT GOTG EXBUG/DON*T STOP 

PSCT PROGRAM SECTION 
0091 A POWERS FDR 1 POWERS OF TEN TABLE 
DO0A A FOB 10 
0064 A FDB 100 
O3EB8 A FDB 1000 
2710 A FDB 10000 

END 
00012 00022* 
00023 00026* 
00018*00022 
00013*00027 
00013*00026 
90012 00030* 

FIGURE 3-3. Message Program 3 (PG3) 
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=RLOAD 


1)?LOAD=P61.R0: 0 


wie =PR1sFGes 


HO UNDEFINED =YMEOL® 


MEMORY MAP 


= SIZE =TR 
A noose 4510 
A oooe 44046 
EB OoniA oon 
ronson ooseA” 
T oo4e O0eR 
Poonrs OORC 


MODULE NAME Be 


Fine noes 
Fas noms 


ENT 
4515 
4$40F 
nna 
noes 
HOA 
Ni1e 


COPYRIGHT BY MOTOROLA 1977 
i SLs REE EL Se rrenanenmersesaeesriats LOAD FIRST FILE 

2 “GB imePeies = wane n anne nnn nnn een ene nnne n= LOAD OTHER TWO FILES 

rat c PREV PES -oc2s22c2c2scsasscsao-2 REPEAT BRSs?1 COMMANDS 
Series aE PRINT UNDEFINED. SYMBOLS MAP 


(6)?MAPF ----------------~--------2------------- PRINT FULL MEMORY/SYMBOL MAP 


CONN 


noagn 
noso 
noed 
nog 


CT DECT PSCT 
Pol nen onea oOAr 


COMMON SECTIONS 


E sik 
& o08c 6d 
& oOno4 


HAME = =E1¢f 
TOM Tong 
TCOMMe DT oo. 


DEFINED =YMEDL= 


MODULE NAME: Fol 


CF AOonoo 


Tl 


M261 P OOAC 
START P ORE 


MOE NAME: FOr 
ENT 


A FSG 
STAEK EF oOoss 


4 


q 


MODULE NAME? Pes 


ATEST A 44o 


nore ooFD 
A oOsc o115 


MEGS Tl 


POWERS P 


6b 


6c 


ooo EXBPRT A Foe4 LE A HOUR ¢ 
O06A MEGSIZ BF oned PGiNE P o0Ce 


oo7s M264 T ooge PaMme FF OOFD 6f 


g 
(7)7EXIT ------2----------=----------=------=-- RETURN TO MDOS 
SLOP) PEGBORY anaciemcnqcienceesnaresenwecs LOAD OBJECT PROGRAM FILE 


| sie RT START PROGRAM EXECUTION 


inn 


MED SAB 
MESSAGE 
COMMON TEST PROGRAM 


EMBUG 2.1 
oF 


FIGURE 3-4. Basic Loader Operation 
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The fourth area of the map (6d) defines the size and starting address of 
any named common blocks. Thus, the PGl variable CMSGST, which is the 
first variable in the DCOMM2 common block, will be located at address 
$8C. The final map feature provides an alphatized list of all global 
symbols by modules (6e, 6f, 6g). The modules are listed in the order 
that they were loaded. Thus, the PGl variable START has an absolute 
address of $B6. 


- To return to MDOS, the EXIT command is used. This command may, in 


addition, be used to assign a starting execution address. In this 
example, PG123's starting address will be at address $B6, since the 
variable START appears as the operand on PGl's END statement. Two 
alternate methods of defining the execution address are: 


EXIT=START 
or EXIT=$B6 


3.3 LOADER OPERATIONS USING INTERMEDIATE FILES 


As shown in the previous example, most commands must be re-entered during pass 2 
of the Loader. The use of an intermediate file eliminates the need to retype 
Loader commands. Figure 3-5 is an example of the use of intermediate files. 
Commands used in the sequence are explained below, with the exception of those 
commands previously discussed. 


1. 


2. 


6. 


The intermediate file feature is invoked by defining a new file for use 
as the intermediate file. 


The IDON command turns the identifier option on to allow printing of the 
IDNT assembly directive as entered in the files. 


This command line shows how more than one command may be specified on the 
same line by using the ';' feature. The STR command is used to define 
the starting section addresses of $400 and $1000 for DSCT and PCST, 
respectively. These starting addresses are reflected in the map 
generated in pass 2. 


The CUR command with the '\' option causes the PSCT section of each 
module to start at an address which is modulo $10 from the start of PSCT. 
This feature permits the user to easily debug relocatable programs, since 
modules start at convenient addresses. Thus, in the example of Figure 
3-5, the first PSCT code for module PG2 will start at $1070. 


Notice that the loading order is different from the example in 
fen 3-4. As each file/module is loaded, its identifier is printed 
5a). 


As in the previous example, the OBJA command initiates pass 2 of the 
Loader. However, since the intermediate file feature is being used, the 
second pass 2 is automatically performed without the user re-entering the 
commands. Notice the identifiers are also printed here as each 
file/module is loaded (6a). 


The Loader has completed processing all commands entered in pass 1; the 
user may now enter any non-load command such as a MAP command or EXIT. 
In this case, all map output is directed to the line printer with the 
MO=#LP command. 


=FLOAD 


MOS LINKING pea 02.00 
COPYRIGHT BY MOTO a77 
VE laatadiesiaenees —_ CREATE, THTERMEDTATE FILE = TEXP 
FETRDA $4003 STRP=$1 0008 STRB=0 --___W- DE E RTING SECTION ADDRESS 
A REUBEN 0 arcsec START a On MoBULO 10 “A py j BOUNDARIES 
5) 7LDAD=P61:FPG2sPG2 --------------------- 
PGi na ine2a MAIN MES@ PROGRAM oN 4 
(5a) PSS Qe-10-79 ASCT ILLUSTRATION - mabtlce a3 
6) 708A pec Tee MESS PRNTR cers START PASS. 2. CONTROLLED BY INTERMEDIATE FILE 
\ O08 INSP OLR = —e ren seeeeemerenenenss ‘ 
aE ee ec asinosa MAIN MESG PROGRAM ~~ MODULE “i 
(6a) PES N8-10°79 ASCT ILLUSTRATION - MODULE #3 
Pae NS-10/79 MPSG PRNTR SUBPROG - MNDULE #2 
7) @MD=8LP --------------------------------- ASSIGN MAP OUTPUT TO LINE PRINTER 
enn BULL ANENORY/SYMBOL MAP TO LINE PRINTER 
PERIT siiae Sar at RN RETURN 1 
SLOAD PGISERV tncmmneencsenensamennceene LOAD OBJECT PROGRAM FILE 
SS a STR TNT START PROGRAM EXECUTION 
1 
i 
MESSAGE 2 
MESSAGE 4 


COMMON TEST PROGRAM 


FIGURE 3-5. Using an Intermediate File 


8. A full map is sent to the line printer to produce a hard copy with the 
MAPF command. The line printer map output is shown in Figure 1-3. 


9. The object file is closed and control is returned to MDOS via the EXIT 
command. 


3.4 LOADER OPERATIONS USING A LIBRARY FILE/CREATING AN MDOS COMMAND 


The previous examples have described the loading procedure performed via the 
LOAD command. In these examples, the user was aware of each module that had to 
be loaded. However, in other cases, the user may be aware of only the entry 
point name required to perform a desired function. In such instances, the user 
can create a file which contains a collection of utility modules. The Loader 
may be used to extract only the required modules from this library file. The 
use of a library file is shown in Figure 3-6, and a description of the various 
steps is explained below: 


1. The MDOS MERGE command is used to build a library file PGLIB. This file 
contains the modules in files PG1, PG2, and PG3. 


2. The use of the BASE command directs the Loader to assign memory for CSCT, 
DSCT, and PSCT above the MDOS system area. As a result, the user program 
may be invoked directly as an MDOS command without using the LOAD 
command. However, if the program has initialized BSCT, the MDOS LOAD 
command must be used to execute the program. The effect of the BASE 
command is shown in the program's memory map where CSCT, DSCT, and PSCT 
are assigned memory above $2000. 


3. All currently undefined symbols are listed via the MAPU command. In this 
example, the six undefined symbols correspond to the six external 
references in PGl. 


4. The LIB command searches the file PGLIB for any modules which satisfy the 
current undefined symbols. Since PG2 and PG3 are modules in PGLIB that 
satisfy these undefined symbols (i.e., PG2 and PG3 have XDEF's for 
ATTEST, EXBENT MSG3, MSG4, PGM2, and STACK), they will be loaded via the 
LIB command. PG1, which is also in PGLIB, will not be loaded again. 


5. The second MAPU command shows that all external references have now been 
satisfied. 


6. The second pass of the Loader is initiated with the OBJA command, and 
creates an object file with the name MESSAGE. The use of the suffix 
"CM', along with the Loader's BASE command, permits the created file to 
be treated as an MDOS command (see item 9). 


7. Since an intermediate file was \not created during pass 1, all commands 
entered in pass 1 must be repeated in pass 2. The MAP, END, and STR 
commands are the only exceptions to this rule. 

8. The EXIT command completes pass 2 of the Loader and returns to MDOS. 


9. The file created by the Loader is treated as an MDOS command and, 
therefore, is loaded and executed automatically. 


(l)=MERGE PG1.RO0:PG2.R0.PG3.R0»PGLIB.RO -------- BUILD LIBRARY FILE 
=PLOAD 
mNO® LINKING LOADER REY o2. 00 
\GOPYRIGHT BY MOTOROLA 1977 


2). kere tanbd ar eapaetae ati mae UNE Ie epars LOCATE PROGRAM 
PLOAD=PG1 -~------------~---2----=--22--20--20---- COAD EIRST PELE CoE MDS 
(S)PMAPU ---n nnn nnn nnn nn enmnanneeaennnnnnennen PRINT UNDEFINED SYMBOLS 


ATEST EXRENT MSG3 90 MSG4 =PGM2 = STACK 


(ay 1 LT | St eunennneneeeenneeieeneaeneeaenenane SEARCH LIBRARY FILE 
iat Renna eure ret == ym eaeaiieadee PRINT UNDEFINED SYMBOLS 
6 

i 


\aRee SMESSABE .CM -=2------------22222-=---------- START PASS 2 - BUILD COMMAND FILE 
5 Ok 0s eon REPEAT PASS 1 COMMANDS 


THEE ees renr-erarame See Sone PRINT FULL MEMORY/SYMBOL MAP 


MEMORY MAP 


SIFE TR END COMN 
none 4510 4515 

node 4496 4408 

no1Aa ooe0 oo39 onoo 
noosa 2000 ener onan 
ni42 2030 enri ooeo 
noes 20Fe 2SOE4 ooo 


MODULE NAME BSCT DSCT PEer 
Pal no20 e030 e072 
Poe noe5 POSE eocs 
PES nnaA ense eonk 


WIA DD 


COMMON =ECTION= 
NAME © =IZE =TRF 
TCOMM Df onne e0he 
TCOMMe Tr Onis FosA 


WEFINED =YMBOL= 


MODULE NAME: Pol 


a A oan FOT A Ooo4 EXEPRT A Foes LF A OO 
M261 P eure M2be D e030 MEGEIZ B O20 PEiINE PF 2058 


START P e20re 

MODULE MAME: Pee : scp — sre 
EXBENT A FSeé4 M25 Te 20s M4 T 2045 Pane P 2003 
STACK B O09 


SOO EET NAME: PGS 


A 4406 POWERS FP ZOD 
i ct emis sn ic tt RETURN TO MDOS 
sat A RCA REASONS LOAD AND EXECUTE NEW MDOS COMMAND 
1 
1 
reed 
= 
MESSAGE 3 
MESSAGE 4 


COMMON TEST PROGRAM 
EX Bll 2.1 
oF 


FIGURE 3-6. Using a Library File 
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3.5 LOADER OPERATIONS USING A CHAIN FILE 


For programs requiring more than a few modules, the use of the MDOS CHAIN 
command to link them becomes a virtual necessity. It also provides a 
self-documenting listing of how to link the program. A sample chain file is 
shown in Figure 3-7. The use of this chain file is shown in Figure 3-8, and a 
description of the various steps is explained below. 


Is 


5. 


6. 


7. 


The chain file (LINK.CF) is invoked using the MDOS CHAIN command. There 
are five option parameters which will be passed on to the chain file. 
This is the only line entered by the operator until (7). 


The chain file pauses here to give the operator a chance to abort, if so 
desired, without destroying anything. 


The previous map and object file are deleted. 


The Linking Loader is invoked via the RLOAD command. The parameters from 
the command line (1) are substituted to define the section values. 


Map output is directed to an output file called PG321.M0. This provides 
a permanent listing of the map output which can be listed at any time. 


The MDOS LIST command is invoked to produce a hard copy of the map file 
on the line printer. Note the header option is used and the DATE command 
line parameter is substituted. The line printer listing of the map 
output files is shown in Figure 3-9. 


The chain file processing ends and the input stream returns to the 
keyboard for operator input. 
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PAGE OO1 LINK eCF20 


/*% 
/% Me Mee RAR REE SAA ERA ERERES AER ELSE 
13 **x LINK MESSAGE PROGRAMS CHAIN PROCESSOR *% 
/* *% 08/10/79 ee 
/* REA RRR AAAAEAAAAAKESSESSSAE SEAL KIS 
1* 


ax 

a* WARNING! GOING TO DELETE THE FOLLOWING FILES: 
* oem PG321-eL0:0 (OLD OBJECT) 

a* PG321.40:0 (OLD RLOAD MAP) 


a* ABORT WITH *BREAK® KEY OR 
ae STRIKE *"RETURN® TO CONTINUE ec 


OSETyM 8 

DEL PG321-L09PG321-M0 

aSET»M O 

RLOAD 

IDON 
STRD=$2%0%ZSSTRP=$2ZPZSSTRB=$2ZBZ 
/TFS CP 

CURP=\N\SZCP% 

sX1F 

LOAD=PG3ePG29PG1 

MAPU 

OBJ A=PG321 
STRD=$2ORZSSTRP=$2PZsSSTRB=$ZBZ 
IFS CP 

CURP=\\S$2CPZ 

/XIF 

LOAD=PG39PG2_9PG1 

MAPU 

MO=PG321-M0 

MAPF 

EXIT 

ax 

LIST PG321-eM0;LH 

MESSAGE PROGRAM TEST RLOAD MAP — 2DATE% 


ax 

JTFC BeDsPe DATE 

s% 

/* COCKPIT ERROR DETECTED! 

4* 

(* MUST SPECIFY THE FOLLOWING OPTIONS: 

IR wr rrr nnn nee 

1% B = START BASE SEGMENT ADDRESS (HEXe NO $) 
* 0 = * DATA * " (HEX» NO $) 
1% Pp = " PROGRAM "™ " (HEX» NO $) 
1% DATE = TODAY'S DATE FOR MAP LISTING 

4* 

/* OPTIONAL 

* CP = HEX VALUE (NO $) FOR “"CURP=\\" COMMAND 
4% 

/% **= CHAIN ABORTED *** 

4% 

ABORT 

/X1F 


FIGURE 3-7. Listing of Chain File Invoking RLOAD 
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(1) =CHAIN LINKS DATEX10 AUG. 1979%s BuO%s Ded 00%» P%1 000%: CP%1 OO 


PHOSPHO SS OSO SEP PS SHOE SOPOSOOOOO PHOS POE SO OD 
oe LINK MFESAGE PROGRAMS CHAIN FROCESSOR oo 
> O8-10-79 ** 
PRPPSSSHP SOS OS SSP PSPSPS SSPE PS SSPSE OOOO DOP OSOOD 


3 IARNING! GOING TO DELETE THE FOLLOWING FILES: 
Sete PGR21.L0:0 «OLD ORJErTS 
Ve Pete1.MO:0 “OLD FPLOAD MAP? 
ale 
ile REORT WITH “EREAK’ KEY OR 
(2) 9. STRIKE “RETURN? TO CONTINUE. 
5l¢ 


YET FORFF oson 
(3) TEL PG321.LO0;Pe321.M0 
PRse1 ~LO:0 DELETED 
PRI21 .MO:0 TELETED 
PZET FOFF onog 
(4) eLoAnD 
MUO= LINK TNS LOADER REY O3. 00 
COPYRIGHT EY MOTOROLA 197 


* TOON 
eT RD= $4003 STRP=F1L0003 =TRB=80 


TCURPPH= 8100 
ee a aa 
Fis ne-1O0- AZCT ILLUETRATION —- MODULE #3 
Pie nee-10- MEZ{6 PRENTR =UBPROG - MODULE v2 
meat ne toes Oa MAIN MEEG FPROGFERAM - MODULE 1 
TMAPI 
HO UNDEF INET £YMBOLE 
soe IRE Geel 
F.TRNHF4Ns = TRPHF1 000s STRE=F0 
FCURP=~8100 
*LOAD=PG3.P62>sPe61 
Pas O8-104F79 RECT ILLUSTRATION - MOTULE 23 
Pie nea-1O0-F9 MESG FRANTR Z=UBPROG —- MOTULE +2 
Pol ne-1o-F?S MATIN MESG PROGRAM —- MOTLULE +1 
MAP 
NO UNDEFINED =*MEOL® 
(5) 7MD=P6321.M0 
?MAPEF 
TERIT 


ql 
(6) LIST PE221.M03LH 
ENTER HEADING: MESSAGE PROGRAM TEST RELOAD MAP - 10 ALG. 1978 


END CHAIN 
VPSLOAD PESRURY ~seeeeen--— 8. LOAD OBJECT PROGRAM 


(8) oF $P a-nnnnnnnnn nanan nanan nnn - =a 8-2 START PROGRAM EXECUTION 


MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
TOMMON TEST PROGRAM 


oe es 


EXBUG 2.1 
o£ 


FIGURE 3-8. Using a Chain file and RLOAD 
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PAGE 001 PG321 e40:0 MESSAGE PROGRAM TEST RLOAD MAP - 10 AUG. 
NO UNDEFINED SYMBOLS 
MEMORY MAP 


SIZE STR END COMN 
0006 4510 4515 

0006 4406 4408 

001A 0000 0019 0000 
0030 0020 O004F 0030 
0042 0400 0441 0020 
0251 1000 1250 0000 


wCOoOOorrn 


MODULE NAME BSCT DSCT PSCT 
PG3 0000 0400 1000 
PG2 0000 0400 1100 
PG1 0015 0414 1200 


COMMON SECTIONS 
NAME S SIZE STR 
DCOMM OD 0008 0422 
DCOMM2 D 0018 042A 
DEFINED SYMAOLS 
MODULE NAME: PG3 
ATEST A 4406 POWERS P 1000 
MODULE NAME: PG2 
EXBENT A F564 MSG3 D 0400 MSG4 D 040A PGM2 P 1100 
STACK B 0014 
MODULE NAME: PG1 
CR A 000D EOT A 0004 EXBPRT A FO24 LF A OOOA 


MSG1 P 1200 MSG2 D 0414 MSGSIZ B 0015 PGINE P 1216 
START P 120A 


FIGURE 3-9. Map Output File Listing 
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1979 


se 


COMMAND 


CONTROL COMANDS 


BASE[=<number> ] 


exrr f<nanel> } 
IDOF 

IDON 
IF=<f-name> 
IFOF 

IFON 

INIT 


oBy[]=<F-nane> 


_|<device> 
MO= ate 


LOAD DIRECTIVES 


LIB=<f-name> [<f-nane>3| i 


LOAD=<f-name> [-tsf-nane>3]"¢ 


APPENDIX A 


A SUMMARY OF LINKING LOADER COMMANDS 


FUNCTION 


LOAD CSCT, DSCT, and PSCT above defined address 
(default=MDOS compatible) 


Give control to the disk operating system 
Suppress identification printing 

Print module identification information 
Specify the intermediate file 
Intermediate file mode off 

Intermediate file mode on 

Initialize the Loader 


Initiates Pass 2 


MAP output 


Enter file mode 


Load the indicated file(s)/module(s) 


COMMAND FUNCTION 


STATE COMMANDS 


B 
CUR<D>=[\ ]<number> Set current location counter 

P 

ASCT 
<number>) | BSCT F 
DEF: <namel>={ names) } spscT | Define a symbol 
PSCT 

B 
END) C \=<number> Set section ending address 

D 

P 
MAPC List user assigned section sizes and addresses 
MAPF List full load map 
MAPS List loader assigned section sizes _ and 

addresses 

MAPU List undefined symbols 

B 
STRJ C\=<number> Set section starting address 

D 

P. 


APPENDIX B 
LINKING LOADER ERROR MESSAGES 


Errors detected by the Linking Loader, while processing a command or loading a 
module, will result in an error message being printed at the user terminal. 
These errors are divided into two classifications: fatal errors and non-fatal 
(warning) errors. When the Loader detects a non-recoverable error, a fatal 
error message will be printed. Any commands not processed on the last command 
line will be ignored and a new prompt printed. If the Loader can recover from 
an error, only a warning message will be printed. 


FATAL 
ERROR MESSAGES 
MESSAGE 

BAE BSCT Assignment Error - the combined size of BSCT is greater 
than the amount that can be allocated in the defined BSCT area. 

COV Common Overflow - the size of a section's common is greater 
than 65,535. 

GAE General Assignment Error - the Loader cannot assign absolute 
memory addresses. This may result from: 

. address conflicts associated with ASCT's 

- user assignment of section addresses 

- the combined length of all sections exceeding 65,535 
- the order in which the Loader assigns memory. 

ICM I1legal Command 

IOR Illegal Object Record - the input module is not a valid 
relocatable object module. 

ISA Illegal Stream Assignment - this error occurs when an invalid 
I/0 device is assigned to a Loader I/0 stream. 

ISY Illegal Syntax - error in the option or specification field of 
a command. This error may also occur when a command is not 
terminated by a semicolon, space, or carriage return. 

LOV Local Symbol Table Overflow - not enough memory for all the 
local (external) symbols defined by the current object module. 
Check for contiguous memory from location @. 

GOV Global Symbol Table Overflow - not enough memory for all the 
global (external) symbols defined by the object modules. Check 
for contiguous memory from location @. 

PHS Phase Error - the absolute address assigned to a global symbol 
at the end of Pass 1 does not agree with the address computed 
during Pass 2. 

SOV Section Overflow - the size of a section is greater than 


65,535. 
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FATAL 


ERROR MESSAGES 


MESSAGE 
UAE 


UIF 
VOI 


WARNING MESSAGES 


User Assignment Error - the user has incorrectly defined load 
addresses. Use the MAPC command to produce a map for 
determining the cause of this error. The UAE error occurs 
when: 


- the user defined end address is less than the user 
defined start address 


. the space allocated by the user defined start and end 
addresses is less than that required for the section. 


. the user has defined load section addresses which 
overlap 


- the user defined execution address is out of range 
. the user has defined ASCT below $20 


- the user has initialized locations in BSCT which are 
assigned below $20 


Undefined IF File 


Undefined Object Input File 


IAM - <address> - Illegal Address Mode - a global symbol is referenced as 


a one-byte operand, and the most significant byte of the global 
symbol address is non-zero. One byte relocation is performed, 
using only the least significant byte of the global symbol 
address. The warning message indicates the absolute address of 
such a reference. 


MDS - <symbol> - Multiply Defined Symbol - the Loader has encountered 


another definition for the previously defined global symbol. 
Only the first definition will be valid. This can also be 
caused by section conflicts for the symbol -- i.e., defined via 
an EQU directive (ASCT) and referenced in another module as 
BSCT. 


UDS - <symbol> - Undefined Symbol - the symbol was not defined during 


Pass 1. A load address of zero will be assumed. 
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